home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / UTIL / PRINTER / S2P / !S2P / !Help next >
Text File  |  1995-11-07  |  10KB  |  278 lines
  1. Instructions for !S2P by Andrew Sellors
  2.  
  3. *****************************************************************************
  4. * NOTE:                                                                     *
  5. * !S2P is FreeWare.                                                         *
  6. * This means that you may freely copy and distribute it, provided that it   *
  7. * is complete with all original files, and that you do not sell it.         *
  8. * PD libraries may charge a nominal fee for the cost of duplication,        *
  9. * postage etc.                                                              *
  10. * In no circumstances shall the author be liable for any damage, loss of    *
  11. * profits, time or data or any indirect or consequential loss rising out of *
  12. * the use of this software or inability to use this software.               *
  13. *****************************************************************************
  14.  
  15. Contents:
  16. ---------
  17.  
  18. Aims
  19. Features
  20. Before you start!
  21. Compatibility
  22. Problems
  23. Operation
  24. Clicking on iconbar icon
  25. Iconbar menu
  26. "Serial To Parallel Configuration" window
  27. Buffers
  28. Setting the 3D bit
  29. Serial Lead Wiring
  30. Contacting the author
  31.  
  32. ********************************************************************************
  33.  
  34. Aims:
  35. -----
  36.  
  37. This program sends all data received by a serial port to the parallel port.
  38. Why????
  39.  
  40. I have two machines, but only one printer and the two machines are not close
  41. together (10 metres in fact). Both machines are connected together using the
  42. serial ports so by configuring !Printers to use the serial port and running
  43. this program on the other machine, I can print from the remote machine.
  44.  
  45. Another use for the program is to enable the Acorn Pocketbook (or Psion
  46. equivalent) to print on a parallel printer by connecting its serial port to
  47. the desktop machine and running this program.
  48.  
  49. ********************************************************************************
  50.  
  51. Features:
  52. ---------
  53.  
  54. Uses 3D bit in CMOS RAM to select 2D or 3D windows _and_ iconsprites on startup.
  55. (See the "Setting the 3D bit" section if you don't like 2D windows)
  56.  
  57. Uses Block Drivers so it can use serial ports other than the internal one.
  58.  
  59. Provides full control over the serial port used.
  60.  
  61. Has the option of mapping the printer data so that a TurboDriver printer cable
  62. can be used.
  63.  
  64. ********************************************************************************
  65.  
  66. Before you start!:
  67. ------------------
  68.  
  69. Before you can use this program you need the Block Drivers by Hugo Fiennes.
  70. If you don't have them then download them now! or look at your favourite
  71. PD library.
  72.  
  73. ********************************************************************************
  74.  
  75. Compatibility:
  76. --------------
  77.  
  78. This program is for RISC OS 3.10 or later.
  79. It has been tested on both RISC OS 3.10 and RISC OS 3.50 and with the internal
  80. port using Block Drivers v10a.
  81.  
  82. ********************************************************************************
  83.  
  84. Problems:
  85. ---------
  86.  
  87. There is a problem with the support of the internal serial port on 'old'
  88. hardware machines (pre A5000) in RISC OS 3.10, which was fixed in 3.11.
  89. Using version 0.21 of the Serial Device Driver for the internal serial port
  90. results in reception at high data rates being very unreliable, with many
  91. characters being lost. For this reason, I have included a small BASIC program,
  92. PatchSDD, which is run when !S2P is started. This updates v0.21 of the Serial
  93. Device Driver to v0.22 and so cures the problems. It checks the version number
  94. so it will only alter v0.21, if you are already loading v0.22 as part of your
  95. boot sequence then no changes are made.
  96.  
  97. ********************************************************************************
  98.  
  99. Operation:
  100. ----------
  101.  
  102. When the !S2P icon is double-clicked, Serial 2 Parallel installs itself on the
  103. left of the icon bar and the configured Block Driver loaded. If the !SerialDev
  104. application that holds the Block Drivers has not been seen by the Filer then
  105. an error is reported and the program does not start up.
  106.  
  107. ********************************************************************************
  108.  
  109. Clicking on iconbar icon:
  110. -------------------------
  111.  
  112. The colour of the printer on the icon indicates whether the serial port is
  113. being redirected to the parallel port:
  114.      Grey printer: Serial port not redirected
  115.    Yellow printer: Serial port being redirected
  116.  
  117. Clicking on the icon toggles this state.
  118.  
  119. ********************************************************************************
  120.  
  121. Iconbar menu:
  122. -------------
  123.  
  124.    +--------------+
  125.    |     S2P      |
  126.    +--------------+
  127.    | Info    ⇨    | ⇨ opens "About this program" window
  128.    | Configure... | Opens "Serial To Parallel Configuration" window
  129.    | Quit         | Quits program.
  130.    +--------------+
  131.  
  132. ********************************************************************************
  133.  
  134. "Serial To Parallel Configuration" window:
  135. -----------------------------------
  136.  
  137. This allows the serial and parallel ports so be set up.
  138.  
  139. Any changes made only take effect when either "Change" or "Save" are selected.
  140.  
  141.  
  142. The "Driver Name" pop-up menu allows you to change the Block Driver used.
  143. When a new driver is selected, the driver is scanned to find the baud rates
  144. and ports supported, and the relevant menus changed accordingly.
  145.  
  146. Clicking on "Rescan Drivers" rechecks the available Block Drivers and updates
  147. the list of drivers for the "Driver Name" menu. This can be used to update
  148. the list if any drivers have been added since the program was started.
  149.  
  150. The "Port Number" pop-up menu allows the serial port to be configured as
  151. some drivers support more than one serial port, the internal driver has only
  152. one port: 0.
  153.  
  154. The other menus are fairly self explanatory, these should be set to the same
  155. as !Printers for the transfer of data to work.
  156.  
  157. Turning on the "TurboDriver Cable" option allows S2P to be used when special
  158. cable for the CC TurboDrivers is being used. If you have a normal cable and
  159. select this option then the printer will print garbage.
  160.  
  161.  
  162. Clicking on "Change" makes any changes made take effect and removes the window
  163. from the screen. If adjust is used instead of select then the window is left
  164. on screen.
  165.  
  166. Clicking on "Cancel" throws away any changes made and removes the window from
  167. the screen.
  168.  
  169. Clicking on "Save" makes any changes made take effect and the saves the
  170. configuration to disc to be used the next time the program is loaded. Whether
  171. the serial port is being redirected is also saved with the options in this
  172. window. If adjust is used instead of select then the window is left on screen.
  173.  
  174. ********************************************************************************
  175.  
  176. Buffers:
  177. --------
  178.  
  179. Increasing the size of the serial input buffer and printer buffer will improve
  180. the speed at which data is transferred and so reduce printing time.
  181.  
  182. The size of the printer buffer is shown by:
  183. *Status PrinterBufferSize
  184.  
  185. I recommend a size of at least 1 page of memory which is achieved by
  186. *Configure PrinterBufferSize 1
  187.  
  188. This will allocate 8, 16, or 32K of memory depending on whether you have 1, 2 or
  189. 4Mb in your machine.
  190.  
  191. Increasing the size of the serial input buffer also helps as the normal buffer
  192. is very small, only 255 bytes and it is only allowed to fill to 155 with the
  193. Block Drivers. This can be done by loading a module such as SerialBuff by
  194. David Pilling.
  195.  
  196. ********************************************************************************
  197.  
  198. Setting the 3D bit:
  199. -------------------
  200.  
  201. If you want to use the 3D windows in this program (and the handful of others
  202. that support it) then you need to set the 3D bit in the CMOS RAM. In RISC OS 3.1
  203. there is no *configure command to change it.
  204.  
  205.    Cut out the following BASIC program and run it.
  206.    Note: this program toggles the bit, so if its off and you run it twice then
  207.          it is still off!
  208.  
  209.     10REM Toggle state of '3D look' bit in CMOS
  210.     20REM Read byte
  211.     30SYS "OS_Byte",161,140 TO ,,byte%
  212.     40REM EOR byte with mask for bit 0
  213.     50byte% = byte% EOR 1
  214.     60REM Write byte back again
  215.     70SYS "OS_Byte",162,140,byte%
  216.     80END
  217.  
  218.     OR
  219.  
  220.     If you have RISC OS 3.5+ then it will probably be on, otherwise you will
  221.     have to then turn off "2D window tools" in the "Window Manager" part of
  222.     !Configure.
  223.  
  224. ********************************************************************************
  225.  
  226. Serial Lead Wiring:
  227. --------------------
  228.  
  229. This lead wiring is the one I use to connect the machines using the internal
  230. ports so I know it works!! It takes account of the strange serial port the older
  231. hardware machines have and should me used with the "Internal" driver rather than
  232. the "InternalPC" driver.
  233.  
  234.  
  235.    Machine 1                        Machine 2
  236.  
  237.  +---1---DCD                        DCD---1---+
  238.  |                                            |
  239.  |   2---RxD------------------------TxD---3   |
  240.  |                                            |
  241.  |   3---TxD------------------------RxD---2   |
  242.  |                                            |
  243.  +---4---DTR                        DTR---4---+
  244.  |                                            |
  245.  |   5---0v--------------------------0v---5   |
  246.  |                                            |
  247.  |   6---DSR------------------------RTS---7   |
  248.  |                                            |
  249.  |   7---RTS------------------------DSR---6   |
  250.  |                                            |
  251.  +---8---CTS                        CTS---8---+
  252.  
  253.      9---RI                          RI---9
  254.  
  255. Note: that on both connectors, pins 1, 4 and 8 are connected together.
  256.  
  257. ********************************************************************************
  258.  
  259. Contacting the author
  260. --------------------
  261.  
  262. I, Andrew Sellors, can be contacted either at
  263.    57 Boundaries Road
  264.    Feltham
  265.    Middlesex
  266.    TW13 5DR
  267.    England
  268.  
  269. Or via Internet email at
  270.    asellors@orac2.demon.co.uk
  271.  
  272. Any feedback from users (bugs reports, requests for new features, praise,
  273. money etc.) is gladly received. 
  274.  
  275.  
  276.  
  277.  
  278.